Summary

• Replace custom JsonDict = Record<string, unknown> with type-fest's stricter JsonObject and JsonValue types
• Add stringifyValue() helper for type-safe JSON value serialisation in URLs, headers, and form data
• Update all source files, tests, and examples to use the new types

Motivation

The previous JsonDict type (Record<string, unknown>) was too permissive, allowing any value including non-JSON-serialisable types like undefined, Date, RegExp, and functions. By using type-fest's JsonObject and JsonValue, we get compile-time guarantees that values are actually JSON-serialisable.

Key Changes

Types (src/types.ts)

• Import and re-export JsonObject and JsonValue from type-fest
• Update JSONSchema interface to use JsonValue for enum, const, default, examples
• Add explicit union type for index signature extensibility

Request Builder (src/requestBuilder.ts)

• Add stringifyValue() helper that properly handles all JSON value types
• Update dry run response to return null instead of undefined for empty body

Meta Tools (src/tool.ts)

• Use JSON.parse(JSON.stringify(...)) to ensure search results are JSON-serialisable

Tests

• Add type guard helpers for safe type narrowing
• Update test expectations for stricter types
• Remove tests for undefined values (not valid in JsonObject)

Test plan

• All 166 tests pass
• Lint passes with zero warnings/errors
• Knip finds no unused exports

Summary by cubic

Replaced the custom JsonDict type with type-fest’s JsonObject and JsonValue for stricter, JSON-serializable types across the codebase. Added a stringifyValue helper for safe URL, header, and form serialization, and made dry-run responses fully JSON-safe.

• Refactors

  • Switched all APIs, tools, request builder, examples, and tests from JsonDict to JsonObject/JsonValue.
  • Updated JSONSchema to use JsonValue for enum, const, default, and examples.
  • Added stringifyValue and used it for path, query, headers, and form serialization; null values are filtered from query; dry-run body is now null and headers are plain objects.
  • Ensured meta tools return JSON-serializable data and tightened types in feedback and headers handling.

• Migration

  • Update tool execute signatures and params to JsonObject/JsonValue.
  • Stop using undefined in params/headers; use null where needed.
  • If you rely on dryRun, expect body: null and plain header objects.
  • Ensure parameters are valid JSON values; non-JSON types (e.g., Date, RegExp, functions) will be stringified or rejected at runtime.

^{Written for commit cd11a6d. Summary will update automatically on new commits.}